Saving Changes

Navigation Services allows you to display a standard alert box for saving changes or quitting an application, and to customize this alert box for other uses.

Note

You are strongly encouraged to make all Navigation Services dialog boxes movable by providing updates via an event-handling function. For more information, see Handling Events.

Displaying a Standard Save Changes Alert Box

To display a standard Save Changes alert box, your application passes its name and the document title to the function NavAskSaveChanges , which displays the alert box shown in Figure 19 .

Figure 19 Standard Save Changes alert box

After the user closes the Save Changes alert box, Navigation Services tells your application which button the user clicked by returning one of the NavAskSaveChangesResult constants, as described in Save Changes Action Constants .

Customizing the Save Changes Alert Box

You can display a customized Save Changes alert box by using the function NavCustomAskSaveChanges . Figure 20 shows an example of a customized Save Changes alert box.

Figure 20 Custom Save Changes alert box

You must provide the message to be displayed in a custom Save Changes alert box.

Displaying a Discard Changes Alert Box

If your application has a Revert to Saved or similar item in its File menu, Navigation Services provides an alert box to handle this situation, as shown in Figure 21 . This alert box is created by calling the function NavAskDiscardChanges .

Figure 21 Discard Changes alert box

After the user closes the alert box, Navigation Services tells your application which button the user clicked by returning one of the NavAskDiscardChangesResult constants, as described in Discard Changes Action Constants .